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mizations that reduce execution time (e.g., by means of call 
devirtualization), and as a basis for tools for program 
understanding and debugging. 
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FIG. 3 

^ , 

import java.lang.Classi 
import )ava.lang. reflect.*: 

public class L { 
static void foo(){ 
try { 

Class c = Class. forNameCM"); 
M fn = (Mlc.newInstanceO i 
Field fid = c.getFieldCx') , 
fld.setlntlm. 10); 

} 

catch (Exception e){ ... } 



static void barl){ 
try { 

Class c = Class. forNameCN') : 

N n = (Nlc.newInstanceO ■. 

Method method = c.getHethodCbaz' .new ClasslO]); 

method. invoke (n. new Object(Ol): 

catch (Exception e){ ... ) 

class H { 
public int X; 

class N { 
public void baz(){ ... } 



03/20/2004, EAST version: 1.4.1 



U.S. 



Patent Apr. 8, 2003 sheet 3 of 4 US 6,546,551 Bl 



FIG. 5 



import java.lang.Class; 
import Java. lang. reflect. «i 

public class A { 
public static void inain(String args(]|{ 

L^food, 

ciass els = Class. forNamel'B'): 

B b = IBlcls.newInstanceO : 

Hethod method = cls.getHethodl'zip'. new Class(0])i 

method. invokeln. new Object(Ol)j 

C"c = new CO , 
c.zapO; 

} 

class B { 
void zip(){ ... }; 



class C { 
void zap (){ ... }; 
void unused {){ ... } ; 

}; 



FIG, 6 

^ 

IMPORT library. conf 
PRESERVECLASS B 
PRESERVEMETHOD B.zipO 
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FIG. 7 

/s , 

import jdva.lang. Class ; 
import java.lang. reflect.*; 

public class L { 
static void foo(){ 
try { 

Class c = Class. forName('H') i 
H m = (Hlc.newInstanceO : 
Field fid = c.getFieldCx'l : 
fld.setlnt(m. 10) •. 

} 

catch (Exception e){ ... ) 

class fi { 
public int X: 

} = 

public class A { 
public static void main(String args[]){ 

LJooOi 

Class els = Class. forName I'B') ! 

B b = (Blcls.newInstanceO ; 

Method method = cls.getMettiodCzip'. new Class! 0])i 

method. invoke (n. new Object(O)) ; 

C'c = new CO; 
c.zapO i 

} = 

class B { 
void zip(l{ ... }; 



class C ( 
void zap l){ ... }; 
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METHOD FOR ACCURATELY EXTRACTING program components by specifying their name. For 

LIBRARY-BASED OBJECT-ORIENTED example, a program can inquire about the name of a class 

APPLICATIONS associated with an object reference, or the number of meth- 
ods defined in a class. Dynamic loading is another example 
5 of reflection. Here, the programmer instructs the platform to 

BACKGROUND OF THE INVENTION lo^d a class with a specified name, after which instances of 

1. Field of the Invention class can be created. For a more detailed description of 
The present invention generally relates to object-oriented J^^^™ reflection mechanism, see McManis, "Take an 

programming (OOP), and in particular to OOP systems ^°-^<=P^^ 1°°^ the Java Reflection API", http:// 

supporting the C++ and Java™ programming languages. www.javaworld.com/jw-09-1997/jw.09.mdepth.html 

2. Description of the Related Art herein mcorporated by reference m its entirety. The use of 

*^ . . , reflection poses a problem for appucation extraction tools 

Object-oriented programmmg languages provide a num- because a static analysis alone cannot determine which 

ber of features such as classes, inheritance, and virtual ^re instantiated using reflection, and which methods 

methods. These object-oriented features have several advan- ^5 -^^^^.^ ^^^^^ reflection. Without this information, a safe 

tages. In particular, they enable the creation of class hbranes approximation of the application's call graph cannot be 

that can be reused by many different appUcations, in many constructed; and without a safe call graph, it is unclear 

different contexts. ^^^^^i methods are unused so that extraction of the appli- 

Qass libraries are usually distributed separately from cation is impossible, 

applications that use them. AdisadvanUge of 20 in order to handle appUcations that tise reflection, or 

distribution model is that the shipped class hbraries can be appUcations that uses class libraries in which reflection is 

very large and hence reqmre large amounts of ^ace to store application extraction tools require additional infor- 

them, and large amounts of tune to download them In cases ^^^^ ^^^^ j„ ^^^^^j application extraction took, 

where an apphcation only uses a small part of a class ,(,5^ information takes the form of a list of the classes, 

hbrary s functionality. distnbuUon of the entire library is 25 methods, and fields in an application that are accessed using 

often undesirable, because the user effectively pays a penalty reflection. This information is then used to construct a safe 

for unused library features. A more detailed descnption of approximation of the call graph, and the application can be 

such problems is set forth m Tip et al., Pracucal expenence ^^^^^^^j ^j^j drawbacks of this approach have to do 

with an apphcation extractor for java™ /„ Proceedmgs of ^^^^^ fact that the set of program components accessed 

theFourteemhAmualConfererKeonObject-OnentedPro- 30 using reflection in a class library depend on the Ubrary 

f-ClT,'"i J^^^"**' 1 .'^PP'''""'°"i features used by an apphcation. Hence, if a user wants to 

(OOPSLA 99) (Denver, Colo., 1999), herem mcorporated ^^^^^j ^^jj appUcations with regard to the same Ubrary, 

by reference m its entirety. j^^^ ^pjj^^^. 

To address this problem, application extraction tools have /in.- * ♦ i u i r * r . • .u 

, , . ^ I- t \ A c u. ^ A- J- (1) Construct a global hst of program components m the 

been designed and implemented. Such tools are discussed in 35 * i_ &* . • , 

A * 1 uo-r.- * ij 1- • . hbrary that may be accessed anywhere m the class 

Agesen et al., "Sifting out the gold: Dehvermg compact i u - « *■ ^n.- i- * c i u j r 

c 1 * u* * • *j hbrary usmg reflection. This hst can safely be used for 

applications from an exploratory object-onented program- , \. ^ ,. ^. . / ... 

V . . » I n J- /• w xr- J A 1 extractmg any appucations with respect to the hbrary; 

ming environment, In Proceedmgs of the Ninth Annual & j ftr t- j* 

Conference on Object-Oriented Programming Systems, 

Languages, and Applications (OOPSLA*94) (Portland, 40 ^ S^^^" apphcation that is to be extracted with 

Oreg.,1994),ACA/5/G/>ZAJVAror/c^5 29(10), pp. 355-370; respect to the library, construct a list of program 

Agesen, "Concrete Type Inference: DeUvering Object- components m the library that are accessed using 

Oriented AppUcations," Sun Microsystems Uboratories reflection in the parts of the Ubrary used by that 

Technical Report SMU TR-96-52, December 1995; Tip et appUcation. 

al., "Practical experience with an application extractor for 45 *^P^^^° advantage that only a single "configu- 

java^"," In Proceedings of the Fourteenth Annual Confer- nation file" needs to be wntten for the Ubrary, but it has the 

ence on Object-Oriented Programming Systems, disadvantage of being overly conservative: the extracted 

Languages, and Applications (OOPSLA'99) (Denver, Colo., appUcations may contain parts of the Ubrary that tiiey do not 

1999); IBM Smalltalk User's Guide, version 3, release 0 ed., ^^e. 

IBM Corp, 1995, Chapters 36-38; SmaUtalk/V for Win32 50 ^P^^°° (^) advantage that each apphcation is 

Programming, Digitalk Inc., 1993, Chapter 17; and Pare- extracted only with the parts of the Ubrary that it uses, but 

Place SmaUtalk, objectworks release 4.1 ed., 1992, Sections disadvantage that a separate configuration file is 

16, 28; herein incorporated by reference in their entirety. required for each application. 

Such tools can perform a static whole-program analysis of Therefore, there is a need in the art to provide a mecha- 

the appUcation along with the Ubraries that it depends on to 55 "^"^ accurately and efficiently extracting object-oriented 

determine the parts of the Ubrary and the application that are components of a library that are potentially used in the 

used. Subsequently, program transformations and optimiza- execution of multiple appUcations. 

application size and download time. 60 The problems presented above and the related problems 

Modem object-oriented programming environments such of the prior art are solved by the present invention, method, 

as the Java"^" platform load object oriented programs and apparatus for accurately extracting library-based object- 

dynamicaUy, create object instances dynamically when they oriented appUcations. The present invention is capable of 

are needed, and link such object instances dynamicaUy for accurately extracting multiple appUcations with respect to a 

execution. In addition, such platforms typically include a 65 class Ubrary. The invention reUes on a single configuration 

reflection mechanism by which an object-oriented program file for the library, which describes how program compo- 

can fetch information about a class of objects, or access nents in the library should be preserved under specified 
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conditions. The invention may be used in application extrac- 
tion tools, and in tools that aim at enhancing performance 
using whole-program optimizations. 

The invention may be used as an optimization to reduce 
application size by eliminating unreachable methods. In the 
ahernative, the invention may be used as a basis for opti- 
mizations that reduce execution time (e.g., by means of call 
devirtualization), and as a basis for tools for program 
understanding and debugging. 

BRIEF DESCRIPTION OF THE DRAWINGS 

FIG. 1 is a block diagram illustrating a data processing 
system on which the subject invention may be implemented. 

FIG. 2 shows a schematic overview of the design of an 
application extractor. 

FIG. 3 shows an example of a class library that uses 
several reflection features. 

FIG. 4 shows a configuration file for the class library of 
FIG. 3. 

FIG. 5 shows an example of an application that uses the 
class library of FIG. 3. 

FIG. 6 shows a configuration file appl.conf for the apph- 
cation of FIG, 5, 

FIG. 7 shows a source-level view of the application of 
FIG. 5 as produced by the application extractor of the 
present invention. 

DETAILED DESCRIPTION OF THE 
INVENTION 

Referring now to the drawings, and more particularly to 
FIG. 1, there is shown a representative data processing 
apparatus on which the subject invention may be imple- 
mented. The computer processing apparatus includes 
memory 101 and a central processing unit (CPU) 103. The 
memory 101 typically includes main memory and cache 
memory for storing instructions to be executed by the CPU 
103 and data to be used in the execution of such instructions. 

The CPU 103 is attached via system bus 112 to user 
interface adapter 107. Typically, the user interface adapter 
107 has attached to it a keyboard, a mouse, and/or other user 
interface, in addition, a display device 105 (such as a 
cathode ray tube display or a liquid crystal display) is 
connected to the system bus 112 via a display adapter 104. 

The computer system's operating system (and other 
utilities), application program code and data are stored in 
persistent memory and temporarily loaded into memory 101 
for execution by the CPU 103. The persistent memory is 
typically provided by a disk drive 108 coupled to the CPU 
via system bus 112. In addition, persistent memory may be 
provided by remote resources coupled to the CPU 103 via 
the system bus 112 and a communication link 109. In this 
case, portions of the computer system's operating system (or 
other utilities), and portions of the application program code 
and data may be retrieved firom remote resources via the 
communication link 109 and loaded into memory 101 for 
execution by the CPU 103. The methodology of the present 
invention as described below is preferably implemented as 
application program code that is stored in persistent memory 
(or retrieved from remote resources) and loaded into 
memory 101 for execution by the CPU 103. 

In order to better understand the invention, some back- 
ground material is presented regarding the notions of class 
hierarchies and virtual method dispatch in object-oriented 
programming languages. The example programs discussed 
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in this document are written in the Java programming 
language. For a definition of the Java language, refer to 
James Gosling, Bill Joy, and Guy Steele, "The Java Lan- 
guage Specification", Addison-Wesley, 1996, herein incor- 
porated by reference in its entirety. 

The following aspects of class hierarchies are relevant for 
the present invention: 
A class hierarchy contains a set of classes. Note that in 
some languages (e.g., Java) the term interface or 
abstract class is used to refer to a class whose func- 
tionality is restricted. Thus, a Java interface may be 
viewed as a class that cannot be instantiated, and which 
only specifies the signatures of the methods that it 
contains. Java interfaces can be treated as classes for 
the purposes of the method described in this document. 
Each class in the hierarchy contains a set of members, 
which includes a set of (virtual) methods and fields to 
be included in objects that are instances of the class. 
A class hierarchy contains a set of inheritance relations 
between classes. A class can extend the functionality of 
another class by deriving from it. The former class is 
referred to as the subclass or derived class, whereas the 
latter class is known as the superclass or base class. 
(Note that some languages, e.g., C++, allow a class to 
have multiple base classes). 
Application Extractor 

FIG. 2 shows a schematic overview of an application 
extractor in which the present invention is incorporated. The 
application extractor consist of the following components: 
A loader which loads the files that comprise the applica- 
tion and its libraries, and constructs an internal repre- 
sentation of the application. In the Java™ platform, the 
loader loads class files that comprise the application 
and its libraries. 
A call graph builder which analyzes the internal 
representation, and constructs a safe approximation of 
the application's call graph, which identifies all meth- 
ods that may be potentially executed when the appli- 
cation is run (also referred to herein as "live"). Any 
method that does not occur in the call graph is definitely 
not executed when the application is run. In construct- 
ing the application's call graph, the call graph builder 
tises a configuration file, the details of which are set 
forth below. 

After construction of the call graph, an optimizer is 
preferably used to remove unreachable methods and 
useless fields (See Sweeney, P. F., and Tip, F., "A study 
of dead data members in C++ applications," In Pro- 
ceedings of the ACM SIGPIAN'9S Conference on 
Programming Language Design and Implementation 
(Montreal, Canada, June 1998), ACM SJGPLAN 
Notices 33(6), pp. 324-332, herein incorporated by 
reference in its entirety). In addition, the optimizer may 
perform optimizations to the methods that remain. Such 
optimizations may include method inlining, class hier- 
archy transformations (See Tip et al., "Slicing class 
hierarchies in C++," In Proceedings of the Eleventh 
Annual Conference on Object-Oriented Programming 
Systems, Languages, and Applications (OOPSLA'96) 
(San Jose, Calif., 1996), ACM SIGPIAN Notices 
31(10), pp. 179-197; and Tip, R, and Sweeney, P, 
"Class hierarchy specialization," In Proceedings of the 
Twelfth Annual Conference on Object-Oriented Pro- 
gramming Systems, Languages, and Applications 
(OOPSLA*97) (Atlanta, Ga., 199*^, ACM SIGPIAN 
Notices 32(10), pp. 271-285; herein incorporated by 
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reference in their entirety), call devirtualization, and 
traditional compiler optimizations such as common 
subexpression elimination, constant propagation, and 
strength reduction (See V. Aho et al., "Compilers 
Principles, Techniques and Tools," Addison-Wesley, 5 
1986; and Ziraa, H. and Chapman, B., "Supercompilers 
for Parallel and Vector Computers," ACM Press, New 
York, 1991; herein incorporated by reference in their 
entirety). Another optimization performed by this com- 
ponent may be the renaming of classes, methods, and 10 
fields (See Tip et al., "Practical experience with an 
application extractor for java™," In Proceedings of the 
Fourteenth Annual Conference on Object-Oriented 
Programming Systems, Languages, and Applications 
(OOPSLA'99) (Denver, Colo., 1999), incorporated by 15 
reference above in its entirety). 
Finally, a writer component produces a set of files com- 
prising the optimized application. These files may be a 
source representation of the program, an intermediate - 
level representation of the program, or a representation 20 
suitable for execution on a particular platform. For 
example, the writer component may produce files suit- 
able for execution on the Java*^" platform (in which 
case the writer component produces a set of class files 
that are suitable for execution on a Java™ virtual 25 
machine). An example of such a class writer compo- 
nent is described in Vallee-Rai et al., "Soot — a Java 
Bytecode Optimization Framework," Proceedings of 
CASCON*99, Nov. 8-11, 1999, Missisauga, Ontario, 
Canada, available firom http://www.sable.mcgill.ca/ 30 
publications/#cascon99 as of the filing of the present 
invention, herein incorporated by reference in its 
entirety. 

The constitutions and functions of these elements are well 
known in the art and will not be otherwise described here, 35 
For example, further description on the various functionality 
of the tool and/or compiler described above may be found in 
A. V, Aho et al., "Compilers Principles, Techniques and 
Tools, Addison-Wesley, 1986, incorporated by reference 
above in its entirety. 40 

Several application extractors have been described in the 
literature. Such tools are discussed in Agesen et al., "Sifting 
out the gold: Delivering compact applications from an 
exploratory object-oriented programming environment," In 
Proceedings of the Ninth Annual Conference on Object- 45 
Oriented Programming Systems, Languages, and Applica- 
tions (OOPSLA'94) (Portland, Oreg., 1994), ACM SIG- 
PLAN Notices 29(10), pp. 355-370; Agesen, "Concrete Type 
Inference: Delivering Object-Oriented Applications," Sun 
Microsystems Laboratories Technical Report SMLI TR-96- 50 
52, December 1995; Tip et al., "Practical experience with an 
application extractor for java™," In Proceedings of the 
Fourteenth Annual Conference on Object-Oriented Pro- 
gramming Systems, Languages, and Applications 
(OOPSLA'99) (Denver, Colo., 1999); IBM Smalltalk User's 55 
Guide, version 3, release 0 ed., IBM Corp, 1995, Chapters 
36-38; Smalltalk/V for Win32 Programming, Digitalk Inc., 
1993, Chapter 17; and ParcPlace Smalltalk, objectworks 
release 4,1 ed., 1992, Sections 16, 28; incorporated by 
reference above in their entirety. 60 
Configuration Files 

The configuration files used by the application extractor 
may include unconditional and conditional directives. 

Unconditional directives specify a set of components of a 
program that are to be classified as potentially executable 65 
unconditionally. In an object-oriented programming plat- 
form such as Java™, the components of a program that are 



specified by a directive preferably includes one or more 
classes of objects, and/or methods and fields to be included 
in objects that are instances of a given class of objects. 
Unconditional directives preferably take one of the follow- 
ing forms: 

PRESERVECLASS <className> 

PRESERVEMETHOD <methodName> 

PRESERVEFIELD <fieldName> 
The semantics of these exemplary unconditional directives 
are as follows. 

Any class C listed in the configuration file using the 
PRESERVECLASS directive is assumed to be instantiated, 
and the application extractor will not make assumptions 
about where objects of type C may occur in the application. 
Furthermore, the application extractor will assume that the 
identity of class C must be preserved. This implies that C 
cannot be removed, renamed or merged into another class. 

Any method m listed in the configuration file using the 
PRESERVEMETHOD directive is assumed to be executed, 
and the application extractor will not make assumptions 
about where method m is called from. Furthermore, the 
application extractor will assume that the identity of method 
m must be preserved. This implies that method m cannot be 
removed or renamed, and that the identity of any class C 
referenced in m*s signature must be preserved as well. 

Any field f listed in the configuration file using the 
PRESERVEFIELD directive is assumed to be accessed, and 
the apphcation extractor will not make assumptions about 
where field f is accessed from. Furthermore, the application 
extractor will assume that the identity of field f must be 
preserved. This implies that f cannot be removed or 
renamed, and that the identity of any class C referenced in 
f s type must be preserved as well. 

Conditional directives specifies: i) a condition associated 
with a first set of components of the program (e.g., the first 
set of components of the program are determined to be 
potentially executable when the program is run); and ii) a 
second set of components of the program that are to be 
classified as potentially executable in the event that the 
condition is satisfied. Conditional directives preferably take 
one of the following forms: 

PRESERVECLASS <className> WHEN 
LIVEMETHOD <methodName> 

PRESERVEMETHOD <methodNamel> WHEN 
LIVEMETHOD <methodName2> 

PRESERVEFIELD <fieldName> WHEN 
LIVEMETHOD <methodName> 
The semantics of these exemplary conditional directives are 
as follows. 

Any class C listed in the configuration file using a 
conditional directive of the form PRESERVECLASS C 
WHEN LIVEMETHOD m directive is assumed to be instan- 
tiated if method m is determined to be live. In this case, the 
application extractor will not make assumptions about where 
objects of type C may occur in the application, and the 
application extractor will assimae that the identity of class C 
must be preserved. This implies that C cannot be removed, 
renamed or merged into another class. 

Any method m listed in the configuration file using a 
conditional directive of the form PRESERVEMETHOD m 
WHEN LIVEMETHOD n directive is assumed to be 
executed if method n is determined to be live. In this event, 
the application extractor will not make assumptions about 
where method m is called from. Furthermore, it will be 
assumed that the identity of method m must be preserved. 
This implies that m cannot be removed or renamed, and that 
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the identity of any class C referenced in m's signature must 
be preserved as well. 

Any field f listed in the configuration file using a condi- 
tional directive of the form PRESERVEFIELD f WHEN 
LIVEMETHOD m directive is assumed to be accessed if 
method m is determined to be live. In this case, it will be 
assumed that the identity of field f must be preserved. This 
implies that f cannot be removed or renamed, and that if the 
type of f is a class C, then C's identity must be preserved as 
well. 

The IMPORT directive serves to enable modular compo- 
sition of configuration files, and takes the form: IMPORT 
<fileNam6>, where <£ilename> is the name of another 
configuration file. This has the same eflfect of adding the 
contents of <filename> to the configuration file containing 
the IMPORT directive. 

Use of Configuration Files by the Call Graph Builder 

The call graph builder preferably operates as follows. The 
operation starts with a set of "root** methods that are either 
directly invoked by the user, or by the run-time system (as 
is for example the case for applets). Then, the following 
steps are repeatedly performed: 

(1) The body of a reached method is analyzed and 
information is collected. Although different call graph 
construction algorithm algorithms determine different 
amounts of information, all such algorithms identify a 
set of call sites in the method. 

(2) For a given call site, a set of target methods is 
determined. A "target method" denotes a method that is 
reachable from a virtual call site via a dynamic dis- 
patch. Different algorithms use a varying amount of 
information to do this. For example, class hierarchy 
analysis only uses the class hierarchy, and RTA also 
uses instantiated class information. Target methods that 
have not been analyzed yet using step (1) need to be 
scanned. Some algorithms reanalyze a method as more 
detailed information becomes available. 

The present invention is preferably integrated into the 
framework described above as follows. As a method is 
determined to be reachable, the configuration file is searched 
for "matching" conditions. If a conditional rule of the form 
"PRESERVEMETHOD m WHEN UVEMETHOD n", 
method m will be analyzed using step (1). Note that this may 
give rise to the identification of additional call sites in step 
(2). 

In addition, the conditional rules of the form: 
PRESERVECLASS c WHEN UVEMETHOD m 
PRESERVEHELD f WHEN UVEMETHOD m 
are useful for algorithms that rely on additional information 
to determine targets of virtual call sites. For example, RTA 
keeps track of the classes that are instantiated in the appli- 
cation in order to approximate the target methods that can be 
reached from virtual method calls. Any class that is found to 
be instantiated using a "PRESERVECLASS c WHEN 
UVEMETHOD m" condition has to be taken into account. 

Any call-graph construction algorithm can be adapted to 
accommodate the configiu-ation file directives described 
above. As an example, we will give a high-level overview 
how the RTA algorithm can be adapted to take into account 
the exemplary conditional and unconditional directives set 
forth above. The RTA algorithm is described in detail in 
Bacon, D. F., "Fast and Effective Optimization of Statically 
Typed Object-Oriented Languages", Computer Science 
Division, University of California, Berkeley, Report No, 
UCB/CSD-98-1017, December 1997, and Bacon, D. F., and 
Sweeney, P. F., "Fast static analysis of C++ virtual function 
calls," In Proceedings of the Eleventh Annual Conference on 
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Object-Oriented Programming Systems, Languages, and 
Applications (OOPSLA'96) (San Jose, Calif., 1996), SIC- 
PLAN Notices 31(10), pp. 324-341, herein incorporated by 
reference in their entirety. We will describe an adaptation of 

5 RTA that simultaneously computes a safe approximation of 
the set of accessed fields as the call graph is constructed, 
along the lines described in Sweeney, P. F., and Tip, R, "A 
study of dead data members in C++ applications," In Pro- 
ceedings oftheACMSIGPLAN'9% Conference on Program- 

10 ming Language Design and Implementation (Montreal, 
Canada, June 1998), ACM SIGPLAN Notices 33(6), pp. 
324-332 (although we will not make the distinction between 
read-access and write-access to fields here). Other algo- 
rithms that can be similarly adapted include class hierarchy 

15 analysis (see Dean et al., "Optimization of object-oriented 
programs using static class hierarchy analysis," In Proceed- 
ings of the Ninth European Conference on Object-Oriented 
Programming (ECOOP '95) (Aarhus, Denmark, August 
1995), W. Olthoff, Ed., Springer- Verlag, pp. 77-101, incor- 

20 porated by reference in its entirety), and type propagation- 
based algorithms (see Agesen, "Concrete Type Inference: 
Delivering Object-Oriented Applications," Sun Microsys- 
tems Laboratories Technical Report SMLI TR-96-52, 
December 1995, incorporated by reference in its entirety). 

25 RTA is an iterative algorithm that maintains the following 
information: 

data identifying a set M of methods to which virtual calls 

have been encountered, 
data identifying a set I of classes that may be instantiated 

during execution, 
data identifying a set R of methods that are reachable 

during execution, and 
data identifying a set F of fields that may be accessed 

during execution. 
RTA begins by performing a number of initializations, 

(a) the data identifying the set R is initialized to identify 
a set of initially reachable methods (such as an appli- 
cation's main method), and the data indentifying sets I, 

40 M, and F are initialized to identify the empty set. 

Then, RTA repeatedly performs the following steps until 
no more elements are added to any of the sets M, I, R, and 
F: 

(b) Process a method in R that has not been processed 
45 before. This involves scanning the method's code for 

virtual calls to other methods, and for instantiations of 
classes. If a virtual call to a method m that does not yet 
occur in M is encountered, data identifying m is added 
to the data identifying set M, If a direct call to a method 

50 n is encountered that does not yet occur in R, data 
identifying the method n is added to the data identify- 
ing set R. If an instantiation of a class c is encountered 
that does not yet occur in I, data identifying class c is 
added to the data identifying set I. If an access to a field 

55 f that does not yet occur in F is encountered, data 
identifying field f is added to the data identifying set F. 

(c) Resolve a virtual call to a method m in M w.r.t. an 
instantiated class c in I. This involves an upward 
traversal of the class hierarchy starting at class c, until 

60 a method m' is found with the same signature as m. If 
data identifying method m' does not already occur in 
the data identifying set R, data identifying method m' is 
added to the data identifying set R. 
Steps (b) and (c) are performed repeatedly until no new 
65 classes are added to set 1, no new methods are added to set 
R, no new methods are added to set M, and no new fields are 
added to set F. 
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RTA only requires a few modifications to accotnmodate 
coDfiguration files with conditional and unconditional direc- 
tives. Unconditional directives are processed as follows: 

(d) when the data identifying the set I of classes is 
initialized, for each class c that is listed in an uncon- 
ditional directive of the form PRESERVECLASS c in 
the configuration file, data identifying the class c is 
added to the data identifying the set of instantiated 
classes 1. 

(e) when the data identifying the set R of methods is 
initialized, for each method m that is listed in an 
unconditional directive of the form PRE- 
SERVEMETHOD m, data identifying the method m is 
added to the data identifying the set of reachable 
methods R. 

(f) when the data identifying the set F of accessed fields 
is initialized, for each field f that is listed in an 
unconditional directive of the form PRESERVEFIELD 
f is added to the set of accessed fields F. 

Preferably, each of the steps (d)-(f) are performed once, 
immediately after performing the initialization of the sets in 
step (a). 

Conditional directives are processed as follows. 

(g) when data identifying a new method m (or m') is added 
to the set R in step (b) (or step (c)), a check is performed 
to determine whether the configuration file contains any 
conditional directive of the form PRESERVECLASS x 
when LIVEMETHOD m (or PRESERVECLASS x 
when LIVEMETHOD m'). In the event that the con- 
figuration file contains such a conditional directive, 
data identifying the class x is added to the data iden- 
tifying set I. 

(h) when data identifying a new method m (or m') is added 
to the set R in step (b) (or step (c)), a check is performed 
to determine whether the configuration file contains any 
conditional directive of the form PRE- 
SERVEMETHOD m" when UVEMETHOD m (or 
PRESERVEMETHOD m" when LIVEMETHOD m). 
In the event that the configuration file contains such a 
conditional directive, data identifying the method m" is 
added to the data identifying set R. 

(i) when data identifying a new method m (or m') is added 
to the set R in step (b) (or step (c)), a check is performed 
to determine whether the configuration file contains any 
conditional directive of the form PRESERVEFIELD f 
when LIVEMETHOD m (or PRESERVEFIELD f 
when LIVEMETHOD m'). In the event that the con- 
figuration file contains such a conditional directive, 
data identifying the field f is added to the data identi- 
fying the set F. 

Preferably, steps (g)-(i) ^^e performed repeatedly along 
with steps (b) and (c), as long as no new elements are added 
to the sets I, M, F, and R, 

EXAMPLE 

FIG. 3 shows a small class library in which reflection is 
used. The library consists of 3 classes: L, M and N. Class L 
has two methods: foo and bar. Method foo uses reflection to 
dynamically load class M, create an object of type M, and 
assign the value *10' to the integer field x of that object. 
Method bar uses reflection to dynamically load class N, 
create an object of type N, and invoke the baz method on that 
object. For convenience, the term library class will hence- 
forth be used to refer to classes that occur in a class library, 
and the term application class will be used to referred to 
classes that are not part of a class library. It is assumed that 
library classes do not inherit from application classes. 
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FIG. 4 shows a configuration file hbrary. conf for the class 
library of FIG. 3. This configuration file specifies the fol- 
lowing: 

class M is instantiated and should be preserved if method 
5 L.foo ( ) is live, 

field M.x should be preserved if method L.foo () is live, 
class N is instantiated and should be preserved if method 

L.bar ( ) is live, and 
method N. baz should be preserved if method L.bar ( ) is 

live, 

FIG. 5 shows an application that uses the h*brary of FIG. 
3. Observe that this application dynamically loads class B, 
that it uses reflection to create an instance of type B, and that 
it uses reflection to invoke method B.zip( ) on that B-object. 

FIG. 6 shows an exemplary configuration file appLconf 
for this application. Observe that the configuration file 
library.conf is imported into this file, and that the class B and 
method B.zip ( ), which are accessed using reflection, are 
listed in unconditional directives as components that should 
be preserved. 

We will now briefly discuss how the call graph construc- 
tion proceeds for the example application of FIG. 5 using 
configuration file appl.conf. 
2j First, the set R of reached methods is initialized to 
{A.main( )}, and I, M, and F are initialized to the empty set 
{ }. Hence, the initial values of these sets are as follows: 

R«{Amain( )} 

HI 
30 M={ } 

Fo{} 

Next, the instructions in the body of method A.main ( ) are 
scanned. Since this method contains a virtual call to method 
C.zap( ), a direct call to L.foo( ), and an instantiation of class 

35 C, then data identifying the method C.zap( ) is added to the 
data identifying set M, data identifying the method L.foo( ) 
is added to the data identifying the set R, and data identi- 
fying the class C is added to the data identifying the set I, 
Hence, we have the following situation: 

40 Ro{A.main( ) , L.foo( )} 
I.{C} 

M={C.zap( )} 

Adding data identifying the method L.foo( ) to data 
identifying the set R triggers a check if there are any 
conditional directives dependent on this method. Since the 
imported configuration file library.conf contains the lines 

PRESERVECLASS M WHEN LIVEMETHOD L.foo( ), 

50 

PRESERVEFIELD M.x WHEN LIVEMETHOD L.foo( ) 
data identifying the class M is added to the data identifying 
the set R, and data identifying the field M.x is added to data 
identifying set F. 

Resolving the virtual call to C.zap( ) in M w.r.t. instan- 
tiated class C in I results in the identification of C.zap( ) as 
a reachable method. Hence, data identifying the mediod 
C.zap( ) is added to the data identifying the set R. Hence, we 
have the following situation: 
go R-{A.main( ), L.foo( ), C.zap( )} 

I-{C. M} 

Mo{C.zap( )} 

F-{M.x} 

After this, no new elements are added to the sets R, I, M, 
65 and F. FIG, 7 shows a source-level view of the application 
program produced by the application extractor. Observe the 
following components have been removed: 
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library class N, 

library method L.bar( ), and 

application method C. iinuscd( ) 
Note that the representation of the application program 
produced by the application extractor need not be a source 
representation as shown in FIG. 7, but may be an interme- 
diate representation of the program, or a representation 
suitable for execution on a particular platform, such as the 
Java™ platform. 

The application extractor may subsequently perform pro- 
gram transformations and optimizations to the methods in 
the call graph, with the constraint that any classes, methods, 
and fields listed in an unconditional or conditional PRE- 
SERVE directive should retain their identity. Specifically, 
classes M and B, field M.x, and method B.zip( ) should 
retain their identity, and should not be renamed or trans- 
formed. 

The incorporation of "conditionally preserve" directives 
in configuration files has the advantage that one can write a 
single configuration file for a class library, which can be 
shared by multiple applications that use thai library. 
Moreover, each application can be extracted precisely, in a 
way that only extracts the library functionality used by that 
application. 

This enables a distribution model for class libraries in 
which the vendor of a library L supplies a configuration file 
F with unconditional and/or conditional directives for 
classes, methods, and fields that are accessed in L, prefer- 
ably via a reflection mechanism in L. In order to extract an 
L-based application A, the user augments F with additional 
directives for A, and uses the resuhing configuration file F' 
to precisely extract the used components of L and A. 

The advantage of this distribution model is that the author 
of the class library (who is familiar with the use of reflection 
in the library) writes the configuration file for the library, and 
that the end-user can precisely extract the library compo- 
nents required by his application, without having detailed 
knowledge of the library code. 

The technique of the present invention may also be 
integrated into an application for program understanding and 
debugging. More specifically, the methodology described 
above may be applied to an input program that uses methods 
in a class hbrary to generate data that identifies components 
of the input program and class library that are potentially 
used in the execution of the input program based upon the 
conditional directive. The identified component(s) are then 
reported to the user via the display device 38 or other user 
interface device for program understanding purposes or 
debugging purposes. 

While the invention has been described above with 
respect to particular embodiments thereof, those skilled in 
the art will recognize that the invention can be practiced with 
modification within the spirit and scope of the appended 
claims. 

We claim: 

1. A method for analyzing an object-oriented program 
implementing reflection comprising a plurality of 
components, the method comprising the steps of: 

providing data including at least one conditional directive, 
wherein the conditional directive specifies i) a condi- 
tion associated with a first set of components, and ii) a 
second set of components that are to be classified as 
live if the condition is satisfied, wherein the plurality of 
components comprise classes, methods, and fields; 

determining whether a given class is live when the given 
class may be instantiated by refection during any 
execution of the program; 
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determining whether a given method is live when the 
given method may be called by refection during any 
execution of the program; 

determining whether a given field is live when the given 
field may be accessed by refection during any execu- 
tion of the program; and 

generating data identifying components that are live based 
upon the conditional directive. 

2. The method of claim 1, wherein the generating step 
comprises the steps of: 

(a) constructing an initial call graph of the program; 

(b) extending the call graph using information about 
components that have been classified as live; 

(c) extending the call graph using the conditional direc- 
tive; and 

(d) identifying in the program any component that is 
classified as live; 

where steps (b). (c), and (d) are preferably performed 
repeatedly until no further components are added to the 
call graph. 

3. The method of claim 2, wherein the condition associ- 
ated with the first set of components is based upon useful- 
ness of the first set of components during any execution of 
the program. 

4. The method of claim 3, wherein the condition associ- 
ated with the first set of components is satisfied if at least one 
component in the first set of components is used during any 
execution of the program. 

5. The method of claim 1, further comprising the step of 
generating a representation of the program based upon the 
data. 

6. The method of claim 5, wherein the representation of 
the program omits components that are determined not to be 
live. 

7. The method of claim 1, further comprising the step of 
identifying at least one component of the program that is 
live, and reporting the at least one component to a user via 
a graphical user interface. 

8. The method of claim 1, wherein the first set of 
components include components that are part of a library 
used by the program. 

9. The method of claim 1, wherein the data including at 
least one conditional directive is derived from at least two 
distinct files, wherein one of the distinct files is associated 
with program, and wherein another of the distinct files is 
associated with the library. 

10. The method of claim 1, wherein one of the distinct 
files includes an import directive that provides a mechanism 
to import directives from another file. 

11. A program storage device readable by a machine, 
tangibly embodying a series of instructions executable by 
the machine to perform method steps for analyzing an 
object-oriented program implementing reflection compris- 
ing a plurality of components, the method steps comprising: 

providing data including at least one conditional directive, 
wherein the conditional directive specifies i) a condi- 
tion associated with a first set of components, and ii) a 
second set of components that are to be classified as 
live if the condition is satisfied, wherein the plurality of 
components comprise classes, methods, and fields; 

determining whether a given class is live when the given 
class may be instantiated by refection during any 
execution of the program; 

determining whether a given method is live when the 
given method may be called by refection during any 
execution of the program; 
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determining whether a given field is live when the given 
field may be accessed by refection during any execu- 
tion of the program; and 

generating data identifying components that are live based 
upon the conditional directive. 

12. The program storage device of claim 11, wherein the 
generating step comprises the steps of: 

(a) constructing an initial call graph of the program; 

(b) extending the call graph using information about 
components that have been classified as live; 

(c) extending the call graph using the conditional direc- 
tive; and 

(d) identifying in the program any component that is 
classified as live; 

where steps (b), (c), and (d) are preferably performed 
repeatedly until no further components are added to the 
call graph. 

13. The program storage device of claim 12, wherein the 
condition associated with the first set of components is based 
upon usefulness of the first set of components during any 
execution of the program. 

14. The program storage device of claim 13, wherein the 
condition associated wath the first set of components is 
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satisfied if at least one component in the first set of com- 
ponents is used during any execution of the program. 

15. The program storage device of claim 11, further 
comprising the step of generating a representation of the 

5 program based upon the data. 

16. The program storage device of claim 15, wherein the 
representation of the program omits components that are 
determined not to be live. 

17. The program storage device of claim 11, further 
comprising the step of identifying at least one component of 
the program that is live, and reporting the at least one 
component to a user via a graphical user interface. 

18. The program storage device of claim 11, wherein the 
first set of components include components that are part of 
a library used by the program, 

19. The program storage device of claim 11, wherein the 
data including at least one conditional directive is derived 
from at least two distinct files, wherein one of the distinct 
files is associated with program, and wherein another of the 
distinct files is associated with the library. 

20 20. The program storage device of claim 11, wherein one 
of the distinct files includes an import directive that provides 
a mechanism to import directives firom another file. 

* * )*c 4c « 
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